home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 184 / showmem2 / showmem2.txt < prev   
Encoding:
Text File  |  1988-07-09  |  2.6 KB  |  70 lines
  1.  
  2. ShowMem2 - The Displayer - runs as .PRG _or_ .ACC
  3. Copyright 1988 John Eidsvoog
  4. version date: 7/9/88
  5.  
  6. This program is public domain.
  7. It may not be sold or distributed commercially without my written permission.
  8. You may freely distribute it otherwise.
  9.  
  10.     ShowMem2 is specially written so that it can be run as either an
  11. accessory _or_ a program.  All you have to do is change the name (using Show
  12. Info) so that the extension (last three letters) is .ACC for an accessory, or
  13. .PRG for a program.  For this reason, I've ARCed ShowMem2 as SHOWMEM2.PCC so
  14. that you'll read this doc to find out why.
  15.  
  16.         ShowMem2 allows you to examine the gemdos memory descriptor lists.
  17. The locations of these lists in memory is not documented by Atari.  For this
  18. reason, this program will only work on specific ROM versions.  It currently
  19. works with the only two ROM versions that I know of.  You will be alerted if
  20. run from an unknown ROM.
  21.  
  22.         You may list the information to the screen or to a printer.  This is
  23. selected from the initial alert box.  The listing will include all allocated
  24. memory blocks, followed by all memory free blocks.  If you hold down the 
  25. 'Alternate' key when you select the output device, you will also get the
  26. memory descriptor waiting list (this is my name for it as its very existence
  27. is undocumented).  When gemdos splits a block into two smaller blocks, it uses
  28. this list to get a new descriptor location.  When two contiguous blocks are
  29. merged, the unused block is put back in this list.  For this reason, the
  30. entries in this list may or may not contain any useful information.
  31.  
  32.     While the listing is scrolling on the screen, you may pause/continue
  33. by using the mouse button.
  34.  
  35.  
  36.     The structure of a memory descriptor is as follows:
  37.  
  38.         long  pointer to next descriptor in list or zero (end of list)
  39.         long  starting address of the block
  40.         long  number of bytes in block
  41.         long  pointer to base page of block's owner
  42.  
  43.         One point that should be raised about free memory, is that when gemdos
  44. returns the bytes available via Malloc(-1), gemdos returns the size of the
  45. largest available block, _not_ the total available memory.  To find the true
  46. total available memory, you have to add up all the memory free blocks.  Of
  47. course, much of this memory is unusable because there may be many small
  48. 'holes' in memory, too small to use.
  49.  
  50.         John Eidsvoog
  51.         P.O. Box 4336
  52.         N. Hollywood, CA 91607
  53.  
  54.  
  55. P.S.  Watch for:
  56.             A/DOS ST
  57.             L
  58.             T
  59.             E
  60.             R    by CodeHead Software
  61.             N
  62.             A
  63.             T
  64.             E
  65.  
  66.             Graphics
  67.             Device
  68.             Operating
  69.             System
  70.